home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / c / ioctl.man < prev    next >
Encoding:
Text File  |  1989-03-27  |  1.8 KB  |  67 lines
  1.  
  2.  
  3.  
  4. IOCTL                 C Library Procedures                  IOCTL
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      ioctl - control device
  10.  
  11. SSYYNNOOPPSSIISS
  12.      ##iinncclluuddee <<ssyyss//iiooccttll..hh>>
  13.  
  14.      iiooccttll((dd,, rreeqquueesstt,, aarrggpp))
  15.      iinntt dd;;
  16.      uunnssiiggnneedd lloonngg rreeqquueesstt;;
  17.      cchhaarr **aarrggpp;;
  18.  
  19. DDEESSCCRRIIPPTTIIOONN
  20.      _I_o_c_t_l performs a variety of functions on open descriptors.
  21.      In particular, many operating characteristics of character
  22.      special files (e.g. terminals) may be controlled with _i_o_c_t_l
  23.      requests.  The writeups of various devices in section 4 dis-
  24.      cuss how _i_o_c_t_l applies to them.
  25.  
  26.      An  ioctl _r_e_q_u_e_s_t has encoded in it whether the argument is
  27.      an "in" parameter or "out" parameter, and the size of the
  28.      argument _a_r_g_p in bytes.  Macros and defines used in specify-
  29.      ing an ioctl _r_e_q_u_e_s_t are located in the file <_s_y_s/_i_o_c_t_l._h>.
  30.  
  31. RREETTUURRNN VVAALLUUEE
  32.      If an error has occurred, a value of -1 is returned and
  33.      _e_r_r_n_o is set to indicate the error.
  34.  
  35. EERRRROORRSS
  36.      _I_o_c_t_l will fail if one or more of the following are true:
  37.  
  38.      [EBADF]        _D is not a valid descriptor.
  39.  
  40.      [ENOTTY]       _D is not associated with a character special
  41.                     device.
  42.  
  43.      [ENOTTY]       The specified request does not apply to the
  44.                     kind of object that the descriptor _d refer-
  45.                     ences.
  46.  
  47.      [EINVAL]       _R_e_q_u_e_s_t or _a_r_g_p is not valid.
  48.  
  49. SSEEEE AALLSSOO
  50.      execve(2), fcntl(2), mt(4), tty(4), intro(4N)
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Sprite v1.0               March 4, 1986                         1
  64.  
  65.  
  66.  
  67.